home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmVaCreateSimpleMenuBar.z / XmVaCreateSimpleMenuBar
Encoding:
Text File  |  2002-10-03  |  6.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr - A RowColumn widget convenience
  10.           creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/RowColumn.h>
  14.           WWWWiiiiddddggggeeeetttt XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr(
  15.           WWWWiiiiddddggggeeeetttt ppppaaaarrrreeeennnntttt,
  16.           SSSSttttrrrriiiinnnngggg nnnnaaaammmmeeee);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr creates an instance of a RowColumn
  23.           widget of type XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR and returns the associated widget
  24.           ID.  This routine uses the ANSI C variable-length argument
  25.           list (_v_a_r_a_r_g_s) calling convention.
  26.  
  27.           This routine creates a MenuBar and its CascadeButtonGadget
  28.           children.  The name of each button is bbbbuuuuttttttttoooonnnn_____n, where _n is
  29.           an integer from 0 (zero) to the number of buttons in the
  30.           menu minus 1.  Buttons are named and created in the order in
  31.           which they are specified in the variable portion of the
  32.           argument list.
  33.  
  34.           _p_a_r_e_n_t    Specifies the parent widget ID
  35.  
  36.           _n_a_m_e      Specifies the name of the created widget
  37.  
  38.           The variable portion of the argument list consists of groups
  39.           of arguments.  The first argument in each group is a
  40.           constant or a string and determines which arguments follow
  41.           in that group.  The last argument in the list must be NULL.
  42.           Following are the possible first arguments in each group of
  43.           _v_a_r_a_r_g_s:
  44.  
  45.           XXXXmmmmVVVVaaaaCCCCAAAASSSSCCCCAAAADDDDEEEEBBBBUUUUTTTTTTTTOOOONNNN
  46.                     This is followed by two additional arguments. The
  47.                     set specifies one button in the MenuBar and some
  48.                     of its resource values. Following are the
  49.                     additional two arguments, in order:
  50.  
  51.                     _l_a_b_e_l     The label string, of type XXXXmmmmSSSSttttrrrriiiinnnngggg
  52.  
  53.                     _m_n_e_m_o_n_i_c  The mnemonic, of type KKKKeeeeyyyySSSSyyyymmmm
  54.  
  55.           _r_e_s_o_u_r_c_e__n_a_m_e
  56.                     This is followed by one additional argument, the
  57.                     value of the resource, of type _X_t_A_r_g_V_a_l. The pair
  58.                     specifies a resource and its value for the
  59.                     RowColumn widget.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           XXXXttttVVVVaaaaTTTTyyyyppppeeeeddddAAAArrrrgggg
  75.                     This is followed by four additional arguments. The
  76.                     set specifies a resource and its value for the
  77.                     RowColumn widget. A resource type conversion is
  78.                     performed if necessary. Following are the
  79.                     additional four arguments, in order:
  80.  
  81.                     _n_a_m_e      The resource name, of type SSSSttttrrrriiiinnnngggg
  82.  
  83.                     _t_y_p_e      The type of the resource value supplied,
  84.                               of type SSSSttttrrrriiiinnnngggg
  85.  
  86.                     _v_a_l_u_e     The resource value (or a pointer to the
  87.                               resource value, depending on the type
  88.                               and size of the value), of type _X_t_A_r_g_V_a_l
  89.  
  90.                     _s_i_z_e      The size of the resource value in bytes,
  91.                               of type _i_n_t
  92.  
  93.           XXXXttttVVVVaaaaNNNNeeeesssstttteeeeddddLLLLiiiisssstttt
  94.                     This is followed by one additional argument of
  95.                     type _X_t_V_a_r_A_r_g_s_L_i_s_t. This argument is a nested list
  96.                     of _v_a_r_a_r_g_s returned by XXXXttttVVVVaaaaCCCCrrrreeeeaaaatttteeeeAAAArrrrggggssssLLLLiiiisssstttt.
  97.  
  98.           For more information on variable-length argument lists, see
  99.           the X Toolkit Intrinsics documentation.
  100.  
  101.           A number of resources exist specifically for use with this
  102.           and other simple menu creation routines.  For a complete
  103.           definition of RowColumn and its associated resources, see
  104.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3).
  105.  
  106.      RRRREEEETTTTUUUURRRRNNNN
  107.           Returns the RowColumn widget ID.
  108.  
  109.      RRRREEEELLLLAAAATTTTEEEEDDDD
  110.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeennnnuuuuBBBBaaaarrrr(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3),
  111.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr(3), and XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3).
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.